PATHMac OS 8 and 9 Developer Documentation > Human Interface Toolbox > Appearance Manager >

Programming With the Appearance Manager


GetThemeMenuBackgroundRegion

Obtains the background region for a menu.

pascal OSStatus GetThemeMenuBackgroundRegion (
                     const Rect *inMenuRect,
                     ThemeMenuType menuType,
                     RgnHandle Region);
inMenuRect
A pointer to a structure of type Rect . Before calling GetThemeMenuBackgroundRegion , set the rectangle to contain the entire menu, in global coordinates.
menuType
A value of type ThemeMenuType . Pass a constant specifying the type of menu (pull-down, pop-up, or hierarchical) whose background you wish to obtain; see Theme Menu Type Constants for descriptions of possible values.
Region
A value of type RgnHandle . Pass a region handle created by your application. On return, the region is set to that of the rectangle specified in the inMenuRect parameter, that is, the menu's background region.
function result
A result code; see Result Codes .
DISCUSSION

The GetThemeMenuBackgroundRegion function obtains the background region that a menu occupies under the current theme.

VERSION NOTES

Available with Appearance Manager 1.0.1 and later.


© 1999 Apple Computer, Inc. – (Last Updated 29 April 99)